Skip to content

Bulk PDO and mysqli grammar fixes - #5712

Merged
kamil-tekiela merged 5 commits into
php:masterfrom
kamil-tekiela:Fix-PDO-and-mysqli-grammar
Jul 30, 2026
Merged

Bulk PDO and mysqli grammar fixes#5712
kamil-tekiela merged 5 commits into
php:masterfrom
kamil-tekiela:Fix-PDO-and-mysqli-grammar

Conversation

@kamil-tekiela

@kamil-tekiela kamil-tekiela commented Jul 25, 2026

Copy link
Copy Markdown
Member

I tried to fix all grammar issues and typos that failed AI check. Most of the changes are superficial with only a few demanding a bigger rewrite. In particular, reference/mysqli/configure.xml was changed to reflect the up-to-date status.

@kamil-tekiela kamil-tekiela changed the title Bulk pdo and mysqli grammar fixes Bulk PDO and mysqli grammar fixes Jul 25, 2026
@kamil-tekiela
kamil-tekiela force-pushed the Fix-PDO-and-mysqli-grammar branch from 1fc24c0 to 963c166 Compare July 25, 2026 20:29

@jordikroon jordikroon left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly small nits. Other than those LGTM.

Comment thread reference/mysqli/mysqli/poll.xml Outdated
Comment thread reference/pdo/pdostatement/execute.xml Outdated
Comment thread reference/pdo/pdostatement/fetch.xml Outdated
named properties in the class
</para></listitem>
<listitem><para>
<listitem><simpara>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we put on a new line?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should I do it in this PR or in a separate PR? This will create a lot of churn if I have to indent all of them now.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's fine if you do it in this PR. Unless someone objects, but will review the commit individually

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you mean if it's trivial. It's not so I leave it up to you. I don't consider it blocking.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CS complained about 8 paras, but there were 9. I hope I didn't break anything.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If it did break, it wouldn't have build in GH Actions. So all good it seems.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can I merge it then?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, LGTM.

Gets an attribute of the statement. Currently, no generic attributes exist but only driver specific:
<itemizedlist>
<listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal>
<listitem><simpara><literal>PDO::ATTR_CURSOR_NAME</literal>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here. It's even worse. Though this was already like this before.

Sets an attribute on the statement. Currently, no generic attributes are set but only driver specific:
<itemizedlist>
<listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal>
<listitem><simpara><literal>PDO::ATTR_CURSOR_NAME</literal>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here.

Comment thread reference/pdo/ini.xml
</term>
<listitem>
<para>
Defines DSN alias. See <methodname>PDO::__construct</methodname> for

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For some reason docbook-cs didn't catch this. Will have to check this myself. But I will not bother you with it.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean the para to simpara here? Is it ok to change it?

@kamil-tekiela
kamil-tekiela force-pushed the Fix-PDO-and-mysqli-grammar branch from 12d52b2 to a8f7a0b Compare July 30, 2026 14:52
@kamil-tekiela
kamil-tekiela merged commit 1cc1b81 into php:master Jul 30, 2026
2 checks passed
@kamil-tekiela
kamil-tekiela deleted the Fix-PDO-and-mysqli-grammar branch July 30, 2026 20:39
KentarouTakeda added a commit to php/doc-ja that referenced this pull request Jul 31, 2026
php/doc-en@1cc1b81 「Bulk PDO and mysqli grammar fixes」(php/doc-en#5712) への追随。

原文側の変更は (a) 英文法・冠詞・タイポの修正と (b) `<para>` から `<simpara>`
への変換で、(a) は訳文に影響しないため、ja 側の変更は (b) のミラーと
EN-Revision の更新のみ。

| 内容 | 件数 |
|---|---|
| `<para>` から `<simpara>` へのミラーと EN-Revision の更新 | 32ファイル(49箇所) |
| EN-Revision の更新のみ | 13ファイル |

内訳: reference/mysqli 25件 / reference/pdo 18件 / appendices 2件

php/doc-en#5712 の対象のうち、訳文の変更を伴う以下の 7 ファイルは本 PR に
含めていない。

- reference/pdo/constants.xml
- reference/mysqli/configure.xml
- reference/mysqli/ini.xml
- reference/mysqli/quickstart.xml
- reference/mysqli/summary.xml
- reference/mysqli/mysqli/poll.xml
- reference/mysqli/mysqli/stmt-init.xml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants